Il file XML per la promozione viene ospitato su un server sul proprio sito e viene aggiornato da un client di Messenger Service a intervalli configurabili. Le stringhe nel file devono essere codificate UTF-8 (il formato ASCII semplice viene automaticamente codificato in UTF-8), ed Φ permesso il formato BOM (Byte Order Mark). AffinchΘ i client di Messenger Service vedano correttamente il contenuto, il formato specificato nel codice XML deve essere seguito in modo rigoroso. Microsoft non Φ responsabile per una codifica XML non corretta e dei relativi effetti. Vedere Contenuti promozionali del client di Messenger Service personalizzato per informazioni generali sull'inclusione di materiale promozionale nel client di Messenger Service personalizzato.
Tabella di riferimento dei tag
| Tag | Descrizione | Principale |
|---|---|---|
| msn-data | Obbligatorio. Il livello di contenitore pi∙ alto di materiale promozionale. | (nessuno} |
| RefreshLogin | Obbligatorio. Un valore booleano che determina quando scaricare nuovi contenuti. Se impostato su True, viene scaricato un nuovo file XML dal server non appena un utente si collega e il timer di aggiornamento viene impostato su zero. Se impostato su False, il contenuto non viene automaticamente aggiornato a ogni collegamento, ma solo quando viene raggiunto l'intervallo prefissato e il timer di aggiornamento viene conservato fra i vari collegamenti. RefreshLogin=True Φ raccomandato. ╚ preferibile impostare RefreshLogin su True se si teme che il server XML riceva un numero elevato di richieste dopo un'interruzione del servizio o a orari di punta. | msn-data |
| RefreshInterval | Obbligatorio. Il numero di minuti da attendere prima di aggiornare l'intero file XML sul client. Se l'utente si collega e RefreshLogin Φ impostato su False, il valore del timer viene conservato fra i vari collegamenti. Il minimo Φ 5, il massimo Φ 10080, ossia una settimana. | msn-data |
| article-group | Contenitore per un insieme di articoli. Ogni gruppo di articoli determinerα il contenuto che deve essere visualizzato all'interno dell'area Promozione e, se ne Φ specificata pi∙ di una, il gruppo di articoli verrα ruotato in modo sequenziale. Almeno un gruppo di articoli deve essere specificato e sono permessi un massimo di cinque gruppi di articoli nel file Promozione XML. In un gruppo di articoli non devono essere inclusi pi∙ di tre collegamenti e una immagine. | msn-data |
| article | Contenitore di ogni singolo articolo. Un articolo pu≥ essere sia un collegamento, impostazione predefinita, oppure una immagine, nel qual caso Φ necessario specificare <article type="image">. | article-group |
| image-url | Specifica l'URL dell'immagine che deve essere usata solo se l'articolo Φ type="image." L'area Promozione pu≥ visualizzare solo immagini gif. I file JPEG non verranno visualizzati. La dimensione raccomandata per l'immagine Φ di 60 x 60 pixel nel caso in cui si visualizzi una immagine con diversi collegamenti. Se viene visualizzata una sola immagine senza collegamenti, ad esempio un banner pubblicitario, la dimensione massima e di 234 x 60 pixel. ╚ possibile usare immagini gif animate. | article type="image" |
| URL | Specifica l'URL che viene caricato in una nuova finestra del browser quando un utente fa clic sul collegamento o sull'immagine. | article |
| title | Specifica il testo da visualizzare come collegamento all'utente. Da usare solo se l'articolo non Φ type="image." | article |
Esempio
<?xml version="1.0"?>
<msn-data>
<RefreshLogin>True</RefreshLogin>
<RefreshInterval>360</RefreshInterval>
<article-group>
<article type="image">
<image-url>http://msdn.microsoft.com/workshop/graphics/icons/xml.gif</image-url>
<url>http://msdn.microsoft.com/xml/index.asp</url>
</article>
<article>
<title>Nozioni su XML a MSDN</title>
<url>http://msdn.microsoft.com/xml/index.asp</url>
</article>
<article>
<title>Guida per sviluppatori XML a MSDN</title>
<url>http://msdn.microsoft.com/xml/xmlguide/default.asp</url>
</article>
<article>
<title>Chat su XML</title>
<url>http://msdn.microsoft.com/chats/xml.asp</url>
</article>
</article-group>
<article-group>
<article>
<title>FAQ su MSN Messenger Service</title>
<url>http://messenger.msn.com/support/knownissues.asp</url>
</article>
<article>
<title>Download di MSN Messenger Service</title>
<url>http://messenger.msn.com/download/download.asp</url>
</article>
<article>
<title>MSN Messenger Service Φ usato in tutto il mondo</title>
<url>http://messenger.msn.com/support/intl_map.asp</url>
</article>
</article-group>
</msn-data>